名前¶

aio_suspend - 非同期 I/O 操作またはタイムアウトを待つ

書式¶

#include <aio.h>

int aio_suspend(const struct aiocb * const cblist[],


                int n, const struct timespec *timeout);

-lrt でリンクする。

説明¶

aio_suspend() 関数は、長さ n のリスト cblist に含まれる非同期 I/O リクエストのうち少なくとも 1 つが完了するか、 シグナルが配送されるか、 timeout が NULL でなく、かつその時間が過ぎるまで、 呼び出したプロセスを停止 (suspend) する。

リストの各アイテムは、NULL (これは無視される) か、 aio_read(3), aio_write(3), lio_listio(3) を使って I/O が開始された制御ブロックへのポインタでなければならない。

CLOCK_MONOTONIC がサポートされる場合、 このクロックを使ってタイムアウトの間隔が計測される。

返り値¶

指示されたリクエストの 1 つが完了した後にこの関数が返る場合は、0 を返す。 それ以外の場合は -1 を返して、 errno を適切に設定する。

エラー¶

EAGAIN

指示された操作のどれも完了しないうちに、 この呼び出しがタイムアウトによって終了させられた。

EINTR

この呼び出しがシグナルによって終了させられた。 signal(7) 参照。 (このシグナルは、完了を待っていた操作のいずれかの完了シグナルの可能性もある。)

準拠¶

POSIX.1-2001.

注意¶

時間間隔が 0 であることを指定する NULL ではない timeout を使って、ポーリングを行うこともできる。

関連項目¶

aio_cancel(3), aio_error(3), aio_fsync(3), aio_read(3), aio_return(3), aio_write(3), time(7)